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Advanced RetroArch Settings 


With ordinary distributions (such as installing RetroArch on Windows), RetroArch is configured by 
adding/editing lines in retroarch.cfg. Batocera generates and replaces the lines in this file with 
every emulator launch, so the better option is to let Batocera know which RetroArch options you 
would like to use. Most of these settings can instead be changed within EmulationStation. Exceptions 
will be noted. 


For options not already implemented into ES, you can change the file 
/userdata/system/batocera.conf and add the following keys if needed. Most RetroArch settings 
not mentioned in the default batocera. conf can be edited and saved from within RetroArch itself 


(accessed by pressing [HOTKEY] + © while in-game in a Libretro core), these will be saved to 
/userdata/system/configs/retroarch/retroarchcustom. cfg (with core options being 
saved to retroarch/cores/retroarch-core-options.cfg instead), however the vast majority 
of RetroArch settings will be overridden by Batocera at emulator launch. 


In order to use the configuration generator to create a RetroArch setting (letting Batocera know which 
value is being used, avoiding it being overwritten), follow the 

global.retroarch.retroarch setting=vaLue syntax. Batocera supports the massive majority 
of RetroArch's settings, but for the few that it doesn't (such as bleeding edge new features or 
obscure/forgotten ones), those settings can still be adjusted by editing them directly into 
/userdata/system/configs/retroarch/retroarchcustom. cfg as they will not be 
overwritten (at least, until Batocera supports them as well). 


Examples 


A.I. Translation 


The following section enables an automatic translation of in-game dialogs in your language. So it's 
possible to play Japanese game titles without hassle. Available from GAMES SETTINGS > Al GAME 
TRANSLATION 


## Enable RetroArch AI game translation service 
global.ai service enabled=0 


global.ai_ service url=http://ztranslate.net/service?api_key=BATOCERA 
global.ai_target_lang= 


Cheats 
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Auto apply cheats selected by the user. 
## Auto apply cheats selected by the user 


global.retroarch.apply cheats after load=true 
global.retroarch.apply cheats after toggle=true 


Savestate Screenshots 


Take a screenshot of the savestate. For when you have many savestates and don't remember which 
is which... now in RetroArch its thumbnail will be a screenshot of the moment you saved! This has 
become the default setting in Batocera. Not available as an ES option. 


## Take a screenshot of the savestate 
global.retroarch.savestate thumbnail enable=true 


Start Screen Message 


Hide the welcome message in Retroarch. Having to wait for 3 secs before the message goes away is 
really boring. This has become the default setting in Batocera. Not available as an ES option. 


## Hide the welcome message in Retroarch 
global.retroarch.rgui_ show start screen=false 


All Users Control Menu 


Allow any RetroPad to control the menu. This changes nothing in 1 player mode, but it's a dream to 
disable when you have friends who don't know the emulators or young children... Only Player 1 (YOU) 
can use RetroArch options like savestate, change slot, rewind, etc. A much better gaming experience. 
Not available as an ES option. 


## Allow any RetroPad to control the menu (Only the player 1) 
global.retroarch.all_ users control menu=false 


Swap OK and Cancel buttons 


Swap the OK and CANCEL buttons on Retroarch menu. Many users have SNES gamepads and in 
EmulationStation, B is OK and A is NO. And in RetroArch, buttons are inverted, and not really 
convenient. Not available as a menu option. 


## Swap the Ok and the CANCEL button on Retroarch menu 
global.retroarch.menu swap ok cancel buttons=true 


OSD Badges 
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Enable OSD (on-screen display) messages. Retroarch shows users some important messages, like 
Savestate, Screenshot, RetroAchievements, etc. They look beautiful on badges. But sometimes, it 
shows other less important messages, like your name when you connect to RetroAchievements. 
Those messages look like crappy yellow text lines, not like the badges. This option hides these 
messages but not the badges. This has become the default option in Batocera. Not available as an ES 
option. 


## Enable usage of OSD messages (Text messages not in badge) 
global.retroarch.video font enable=false 


Sync to Exact Content Framerate (G-Sync, FreeSync) 


This will enable variable refresh rate for compatible displays. This sync your display's refresh rate to 
the emulated console's display rate (unlike traditional v-sync that will simply delay the frames until 
the display is ready). Only compatible on displays that explicitly have support for “variable refresh 
rate” (most of them don't). Now available as an ES option. 


## Enables syncing to exact content framerate (variable refresh rate, G- 


sync, Freesync, etc.) 
global.retroarch.vrr_runloop enable=true 


Adjust per-game volume 


Not all games are created equal... in terms of decibels they produce. Use the following to adjust the 
volume output by a particular game (use negative numbers to reduce its volume instead): 


## Adjusts the volume for the game SydMead's TerraForming (USA).chd in the 
pcenginecd folder to be 10 decibels louder than usual. 


pcenginecd["SydMead's TerraForming (USA).chd"].retroarch.audio volume = 
"10.000000" 


Alter FPS update interval 


When you turn on the SYSTEM SETTINGS > FRONTEND DEVELOPER SETTINGS > SHOW FPS, 
you may notice in RetroArch specifically the FPS counter is very unresponsive... this is because the 
default interval is set to update once every two and a half seconds. To change this to update every 10 
ms: 


global.retroarch.fps update interval=10 


Core options 


Q It might be worth checking if the option you want to set is already available in the 
ADVANCED SYSTEM OPTIONS first! You can quickly access this for your system by 
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In order to set specific core options (ones that are saved to 
/userdata/system/configs/retroarch/cores/retroarch-core-options.cfg (may cause 
conflicting issues, advanced users only) use the global. retroarchcore.<core name> <core 
option>=va Lue syntax (takes priority over other settings, even settings that are normally required 
to be adjusted to run games, be warned). For example: 

global. retroarchcore.genesis plus gx region detect=pal would set the region to PAL 
for games run with GenesisPlusGX. 


Each core option is (usually) unique to the core, you can see what terminology it uses with the 
following: 


1. Launch a game and go into the RetroArch Quick Menu and navigate to the core's options ( 


[HOTKEY ] + > Core Options (this used to be labelled simply Options in older versions of RetroArch)). 
2. Edit your options if you want to, and then go to Manage Core Options > Save Content 
Directory Options. 
3. Check the newly created file at /userdata/system/.config/retroarch/config/<core 
name>/<system>.opt 


Y You may need to turn on “Show hidden folders” in your file manager to see this 
folder. 


4. Transplant those options to batocera.conf by appending them with 
global.retroarchcore. first. It's okay to enclose the values in double-quotes like RetroArch 
does (eg. = "value") or not include any double-quotes like Batocera does (eg. = value). 

5. Delete the /userdata/system/.config/retroarch/config/<core 
name>/<system>. opt file (or just Delete Content Directory Options (which has replaced 
Save Content Directory Options from earlier)). 


To run with our previous example, | would: 


1. Launch “Shaq Fu” for the Sega Megadrive, mash [HOTKEY] 1 and then go into the Options 
menu. 
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© Options 


Q, Manage Core Optior: 


M [M2413] 


YM2413) core 


ng filter 


2. Change the System region option from “auto” to “pal”. 


Batocera.linux - Wiki - https://wiki.batocera.org/ 


Last update: 2024/02/16 19:23 advanced_retroarch_settings https://wiki.batocera.org/advanced_retroarch_settings 


“ Options 


@ Manage Core Optior 


‘9 Manage Core Options 


File 
jame Options 
mtent Directory Options 


shor 
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“@ Manage Core Options 


4. Check the option file that was created at 
/userdata/system/.config/retroarch/config/Genesis Plus GX/megadrive.opt 


A » share >» system » .config > retroarch » config » Genesis Plus GX 
TTT 


New folder 
» megadrive.opt 


inf | OPT File 


5. Take a gander at the option | set, and note that it is genesis plus gx region detect = 


"pal". 
genesis_plus_gx_overscan = “disabled” 
genesis plus gx region detect = “pal” 
genesis plus gx render = “single field” 
genesis plus gx sound output = “stereo” 
6. Open up batocera.conf and add 
global. retroarchcore.genesis plus gx region detect = "pal" to it. 


7. Delete the megadrive. opt file. 


Zs 
=x 
w 


All my Mega Drive games now run at PAL speeds, as they should be. 
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© Hardcore paused. Setting not allowed: genesis plus gx region detect=pal 


Reconfiguring the Keyboard for RetroArch 


This is for if you'd like to reconfigure the default keyboard bindings for all systems emulated by a 
libretro core (Such as if you don't have a controller to use or you're in an all-in-one device like a 
netbook). Setting this will prevent you from using a controller configured from ES in libretro 
cores until you undo this. Not available as an ES option. 


Keep in mind that this is just translating your keyboard to the RetroPad. The RetroPad is 
independent of the system and will be assigned to the appropriate system controls when 
that emulator is booted up. You can read more about that and its philosophy 


Open your /userdata/system/batocera. conf file and add the following lines as appropriate to it. 
Here is an example of the default bindings: 


# Face buttons 

global.retroarch.input playerl a=x 
global.retroarch.input playerl b=z 
global.retroarch.input playerl x=s 
global.retroarch.input playerl y=a 


# D-pad 

global.retroarch.input_ playerl down=down 
global.retroarch.input playerl left=left 
global.retroarch.input playerl right=right 
global.retroarch.input playerl_ up=up 


# Shoulder buttons 
global.retroarch.input playerl l=q 
global.retroarch.input playerl r=w 
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global.retroarch.input_ playerl lt2=nul 
global.retroarch.input playerl r2=nul 


# Start and Select 
global.retroarch.input playerl select = rshift 
global.retroarch.input playerl start = enter 


# Left analog 

global.retroarch.input_playerl l x _minus=nul 
global.retroarch.input playerl l x plus=nul 
global.retroarch.input playerl l y minus=nul 
global.retroarch.input playerl l y plus=nul 


# Right analog 

global. retroarch.input_playerl r x minus=nul 
global.retroarch.input player1 r x plus=nul 
global.retroarch.input playerl r y minus=nul 
global.retroarch.input playerl r y plus=nul 


# Analog buttons 
global.retroarch.input player1 l3=nul 
global.retroarch.input playerl r3=nul 


# The Hotkey 
global. retroarch.input_ enable hotkey=nul 


If you'd like your keyboard bindings to only apply to a particular system, replace the global part with 
the shortname for your system (eg. psx for the Sony PlayStation). 


A It must be stressed that this is only for libretro cores; this does nothing for standalone 
emulators! Refer to this page for more info. 


Rebinding RetroArch's hotkeys 


If you were looking for how to change the functions of your handheld's function keys, refer to this 
page instead. 


The hotkey combos that Batocera offers are nice, but what if you wanted to bind a hotkey action 
directly to an unused button (such as putting fast-forward on the unused [R2] button for GBA 
games)? This is for that. Once again, keep in mind this will only affect libretro cores, not standalone 
emulators. 


Open your /userdata/system/batocera. conf file and add the following lines: 


## The hotkey enable button. Equivalent to Batocera's [HOTKEY]. Making this 
"nul" will disable the requirement for holding the hotkey first to activate 
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commands with button presses. 
global. retroarch.input_ enable hotkey _btn=nul 


You'll have to figure out what your internal button names are using evtest from the terminal/ssh 
session. Here is a list of the common Batocera names (using an Xbox 360 controller): 


RetroArch 


Event code binding 


(æ) 


ii 


4 BTN 


W 
oO 
ul 


Oo 
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TN C 
WEST C o O 
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START 
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THUMBR (R31, pushing the right stickin | 
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3 
® 
© 


w| W 
HE 
Z 


O 

(oc) 
Ww 
4 


4 


| W| |W 
J 4 
ZZ zZ zZ 


= 


ius] 
Z 


> 
(oe) 
wn 


a 
ius) 
Nn 


RZ [R2], Right analog trigger 


D-pad up/down, value -1 for up, 0 for neutral, 1 for 
down 


> 
fee) 
wn 


BB 
w | W 
NJU 


> 


hOup/hOdown ATOY 


(o>) 


hOleft/hOright ABS 


oo 
3100 
ee 
B 
C 
C 
E 
C 


BTN = Button, ABS = Absolute position (commonly analog sticks, but also includes analog triggers 
and the D-pad (yep, the D-pad is just a virtual analog stick)). 


Then add/edit the following lines as appropriate to batocera. conf. Here is a non-exhaustive list of 
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RetroArch input commands (with the default buttons for an Xbox 360 controller): 


## Exit the current emulator. Equivalent to [HOTKEY]+[START]. 
global. retroarch.input_exit_emulator_ btn=7 


## Open RetroArch's Quick Menu. Equivalent to [HOTKEY]+[SOUTH]. 
global.retroarch.input_ menu toggle btn=0 

## Save current state to the selected slot. Equivalent to [HOTKEY]+[WEST]. 
global. retroarch.input_ save state btn=2 

## Load the state from the selected slot. Equivalent to [HOTKEY]+[NORTH] . 
global.retroarch.input load state btn=3 

## Reset the emulated system (can cause bugs with certain settings/games) . 
Equivalent to [HOTKEY]+[EAST]. 

global. retroarch.input_reset_btn=1 

## Increase the currently selected save state slot. Equivalent to 
[HOTKEY]+[D-PAD UP]. 

global.retroarch.input state slot increase btn=hOup 

## Decrease the currently selected save state slot. Equivalent to 
[HOTKEY]+[D-PAD DOWN]. 

global. retroarch.input_ state slot decrease btn=hOdown 


## Toggle the AI translation service. Equivalent to [HOTKEY]+[R1] 
global.retroarch.input ai service btn=5 

## Fast-forward (hold). Equivalent to [HOTKEY]+[D-PAD RIGHT] 
global.retroarch.input hold fast forward btn=hO0right 

## Rewind. Equivalent to [HOTKEY]+[D-PAD LEFT] 

global. retroarch.input_rewind btn=h0left 

## Take a screenshot. Equivalent to [HOTKEY]+[L1]. 
global.retroarch.input screenshot _btn=9 

## Next shader. Equivalent to [HOTKEY]+[R2]. 

global. retroarch.input_shader_next_btn=nul 

## Previous shader. Equivalent to [HOTKEY]+[L2]. 

global. retroarch.input_shader_prev_btn=nul 


## Hotkey (for holding). Setting this to anything but nul will re-enable the 
combo requirement. 
global.retroarch.input enable hotkey _ btn=8 

## Eject the virtual disc. 
global.retroarch.input disk eject toggle btn=4 

## Select the next disc. 

global.retroarch.input disk next_btn=nul 

## Select the previous disc. 
global.retroarch.input_ disk prev_btn=nul 

## Toggle the FPS display. 
global.retroarch.input fps toggle btn=nul 

## Advance one frame. 

global. retroarch.input_frame_ advance btn=nul 

## Slow-motion (hold). 

global. retroarch.input_hold_slowmotion_ btn=nul 

## Record movie toggle. 

global. retroarch.input_movie record toggle btn=nul 
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## Netplay watch toggle. 
global.retroarch.input_netplay game watch btn=nul 
## Netplay host toggle. 
global.retroarch.input netplay host toggle btn=nul 
## OSK toggle. 
global.retroarch.input_osk toggle btn=nul 

## Pause emulation. 
global.retroarch.input pause toggle btn=nul 

## Input recording toggle. 

global. retroarch.input_recording toggle btn=nul 
## Runahead toggle. 
global.retroarch.input runahead toggle btn=nul 

## Streaming toggle. 
global.retroarch.input streaming toggle btn=nul 
## Fast-forward toggle. 
global.retroarch.input toggle fast forward btn=nul 
## Slow-motion toggle. 
global.retroarch.input_toggle slowmotion btn=nul 
## Turbo default button. 
global.retroarch.input_ turbo default _button=0 


If you'd like to be able to open the Quick Menu with an alternative button combo, you can utilize any 
of RetroArch's built-in combos: 


## Only open the RetroArch Quick Menu with the hotkey command. 
global.retroarch.input_menu_toggle gamepad combo=0 

## Open the RetroArch Quick Menu with Down + Y + L1 + R1. 
global.retroarch.input_menu_toggle gamepad combo=1 

## Open the RetroArch Quick Menu with L3 + R3. 
global.retroarch.input menu toggle gamepad combo=2 

## Open the RetroArch Quick Menu with L1 + R1 + Start + Select. 
global.retroarch.input menu toggle gamepad combo=3 

## Open the RetroArch Quick Menu with Start + Select. 
global.retroarch.input_menu_toggle gamepad combo=4 

## Open the RetroArch Quick Menu with L3 + R1. 
global.retroarch.input menu toggle gamepad combo=5 

## Open the RetroArch Quick Menu with L1 + R1. 
global.retroarch.input_ menu toggle gamepad combo=6 

## Open the RetroArch Quick Menu by holding Start for 2 seconds. 
global.retroarch.input menu toggle gamepad combo=7 

## Open the RetroArch Quick Menu by holding Select for 2 seconds. 
global.retroarch.input_menu_toggle gamepad combo=8 

## Open the RetroArch Quick Menu with Down + Select. 
global.retroarch.input_ menu toggle gamepad combo=9 

## Open the RetroArch Quick Menu with L2 + R2. 
global.retroarch.input menu toggle gamepad combo=10 
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Open the Quick Menu via Shift + F1 


By default, Batocera will have the [Esc] key on the keyboard bound to immediately exiting 
RetroArch. In order to revert this to behave similarly to RetroArch's default behavior, modify the 
following lines in system/configs/retroarch/retroarchcustom. cfg to the following: 


input_enable hotkey = "shift" 
input menu toggle = "f1" 


Using this, you can now access the Quick Menu even if you only have a keyboard! How neat. 


Batocera will not change these specific variables. So as long as you don't do a factory 
reset, this setting will persist. 
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